home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 010 / chess151.arc / SYSOP.DOC < prev    next >
Encoding:
Text File  |  1987-03-29  |  17.9 KB  |  507 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                  CHESS MONITOR PROGRAM FOR DOORS
  11.  
  12.                              for the
  13.  
  14.                       IBM Personal Computer
  15.  
  16.                           Version 15.XX
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                by
  24.  
  25.                        Bob Westcott
  26.                        7 Dunloggin Drive
  27.                        Merrimack N.H. 03054
  28.                        Voice (603) 424-6977
  29.                        Data  (603) 424-5497
  30.  
  31.                          April 1, 1987
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. First thing I must do is to thank Tom Mack and Jon Martin for the 
  63. time,   energy  (and  love)  for  the best BBS  in  the  country.  
  64. Without  there  effort  none of us would be able to  run  such  a 
  65. wonderful piece of software such as the RBBS-PC.
  66.  
  67. 1.1 Indroduction
  68. ----------------
  69. The  Chessdor program is a program that will allow you to run  it 
  70. out of the (D)oor's area of the RBBS.  It comes complete with all 
  71. required  programs and batch files.   As in all software we  hope 
  72. there are no bugs,  but if you find some please inform me so that 
  73. they can be corrected and make this a useful part of the RBBS.
  74. If  you would like to see the software in operation you may  call 
  75. my RBBS and leave a comment to be registored and list yourself as 
  76. a  sysop  with the phone number of your RBBS and I will give  you 
  77. the  required access level to look at chess and see the games  in 
  78. action.
  79.  
  80. Because  it  us very possible to cause a security problem on  the 
  81. RBBS (people being able to get into your DOS) the source will not 
  82. be made available.   I will help anyone who is interested in  the 
  83. way you write software to work on the 'Doors' that calls. 
  84.  
  85. The software is able to handle multi-tasking under Multi-Link and 
  86. Double Dos, but is limited to only 2 nodes.
  87.  
  88. 1.2 Update Conventions
  89. ----------------------
  90. Since  this  software is very closely tied to the  RBBS  software 
  91. I  will  update  it  when new  version/levels  of  the  RBBS  are 
  92. released.   The version level of CHESSDOR will be the same as the 
  93. version level that it will work with of the RBBS.
  94. I  will try to have the latest versions on both Tom Mack and  Jon 
  95. Martin  boards and of course the latest version will always be on 
  96. my RBBS.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111. 1.3 What is CHESSDOR 
  112. --------------------
  113. CHESSDOD  is  a program that will allow your users to play  chess 
  114. with  each other (not with the computer).
  115. This program has only been tested on a IBM-XT,  but should run  on 
  116. all computers that the RBBS will run on.
  117. It will:
  118.  1. Monitor all moves to insure they are valid.
  119.  2. Inform both players if either are in check.
  120.  3. Allow castling.
  121.  4. Allow pawn promotion.
  122.  5. Let non-players see any of the games that are in progress.
  123.  6. Inform players if it is they move.
  124.  7. Display what openings are available to play.
  125.  8. Allow the sysop to run both local and remote.
  126.  9. Let  the sysop make moves that are invalid to set up problems 
  127.     if wanted and correct program boo boo's.
  128.  10.Allow the sysop to chat with players.
  129.  11.Allow the sysop to increase or decrease time in Chess.
  130.  12.Let the sysop set the colors his wishes (on his computer).
  131.  13.Allow  the sysop to set the amount of time allowed  in  chess 
  132.     and the amount of time without a entry from the player.
  133.  14.Let  the sysop set the amount of games that may be played  at 
  134.     once. (Max is 30).
  135.  15.Automatically set up the game boards when first started and a 
  136.     new game board when someone quits.
  137.  16.Show players and viewers the score and last 5 moves of each
  138.     player.
  139.  
  140. It will NOT:
  141.  1. Inform  players  when  they are in  checkmate.  (Player  must 
  142.     quit).
  143.  2. Return  you  to  the RBBS  unless you have the fix to the new 
  144.     compilers.
  145.  3. Inform the players of a stalmate.
  146.  
  147. 2.1 Required files
  148. ------------------
  149. You  must have a batch file that you are running your RBBS  from. 
  150. The   other   files  are  supplied  and  are  the   CHESSDOR.EXE, 
  151. CHESSDOR.DOC, CHESSDOR.SCR, and CHESS.BAT file.
  152. Also supplied are the SYSOP.DOC file and a PRELOG.CHS file.
  153. The purpose of the files are as follows:
  154.  1. CHESSDOR.EXE   The operational software.
  155.  2. CHESSDOR.DOC   The  file  which informs the player  who  what 
  156.                    when and where.
  157.  3. CHESSDOR.SCR   This is the  score  board,  but it is also the 
  158.                    file that holds your system requirements.
  159.  4. CHESS.BAT      The batch  file that gets you to CHESSDOR from 
  160.                    the doors
  161.  5. SYSOP.DOC      This file.
  162.  6. PRELOG.CHS     The same as on the RBBS it allows you to place 
  163.                    notices on the system.
  164.  
  165.  
  166. 2.0 Setup
  167. ---------
  168. Because this software reads information from the RBBS files it is 
  169. very important that the supplied files MUST be placed on the same 
  170. drive that the RBBS-PC.DEF, RBBS1PC.DEF, RBBS2PC.DEF are located.
  171.  
  172. The sysop's name, the name of your RBBS, the users name, the comm 
  173. port that is use,  the number of data bits,  and the baud rate is 
  174. taken  from  the  RBBS  files and used in  the  CHESSDOR  program 
  175. without any need for you to insert them in a file.
  176. You must supply the following information in the 1st 5 fields  of 
  177. the CHESSDOR.SCR file:
  178.  
  179.  1. Field #1 The number of games you are allowing at once. Max of 
  180.              30 games are allowed.
  181.  2. Field #2 The foregound color.
  182.  3. Field #3 The backgroung color.
  183.  4. Field #4 The  number  of minutes a player is allowed  without 
  184.              making a move.
  185.  5. Field #5 The total number of minutes allowed on chess.
  186.  6. Field #6 1=You are using the Door Monitor 0=No Door Monitor
  187.  
  188. If  the first 5 fields were 5,7,0,10,15,0 they will mean that you 
  189. are allowing 5 games to be played at once,  the foreground  color 
  190. is  gray,  the  backgroung color is black,  the player can go  10 
  191. minutes without making a keyboard entry, the max. time allowed in 
  192. chess is 15 minutes, and you are not using the Door Monitor.  The 
  193. player always gets warnings the last four minutes of his time  at 
  194. 1 minute intervals.
  195. The  rest of the file is free format.   You can look at the  file 
  196. supplied and see what I have set up.
  197.  
  198.  
  199. In all of the following examples I have drive A as my boot  drive 
  200. and when using DOUBLE DOS it is installed on my disk C,  and when 
  201. using MULTI-LINK it is located on drive A.
  202.  
  203. I  don't  want you to think that the following examples  are  the 
  204. only way to set up you system or even the best they are ways that 
  205. will work and have been tested to work.
  206.  
  207. The following is a example of how my batch files are setup:
  208.  
  209. All  of the following files have been supplied as stated in  this 
  210. doc. for your use  and should be changed to work on your system.
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218. The following is for a NON-MULTI TASKING system
  219. -----------------------------------------------
  220.  
  221.  (The  RBBS.BAT file kept on drive A to do  auto  reboots,  power 
  222.   failures etc.)
  223.  
  224.   C:                                 Go to drive with RBBS files.
  225.   ASTCLOCK                           Restore clock and time of day.
  226.   PROMPT $P $G                       Set up the prompt that I like.
  227.   WATCHDG1 OFF                       Turn watchdog off.
  228.   IF EXIST C:RCTTY.BAT DEL RCTTY.BAT To remove RCTTY.BAT file.
  229.   RBBS-PC                            Call RBBS program.
  230.   WATCHDG1 ON                        Place watchdog on.
  231.   IF EXIST C:RCTTY.BAT C:RCTTY.BAT   Run the RCTTY.BAT file. (**)
  232.   A:                                 Return to drive A.
  233.   RBBS.BAT                           Restart this file.
  234.  
  235. (**)  This is where the RBBS software inserts what door file  you 
  236. are using if one was called if no door was called then batch file 
  237. continues on its way without going to CHESS.BAT.  This same  file 
  238. gets  you  to be remote sysop.   To get a better idea of  how  it 
  239. works you can go to doors,  while in local,  break the batch loop 
  240. before the watchdog gets you and look at the RCTTY.BAT file.
  241.  
  242.  
  243.  (The CHESS.BAT file located on drive C)
  244.  
  245.   C:                                 Insure we are on C drive.
  246.   WATCHDG1  OFF                      To allow chess program to 
  247.                                      monitor line (a must!!)
  248.   CHESSDOR  %1                       Call the chess monitor pgm.
  249.  
  250. DO NOT call the RBBS.BAT file when using version 15.xx of RBBS!!
  251.  
  252. The door menu file called MENU5 is also supplied.
  253.  
  254. The following is for Double Dos
  255. -------------------------------
  256. You must be running DOS 3.X or higher.
  257. You must have the following files:
  258.  
  259.  1. RBBS1.BAT              Node 1 calling batch file
  260.  2. RBBS2.BAT              Node 2 calling batch file
  261.  3. CHESS-1.BAT            Node 1 chess calling batch file
  262.  4. CHESS-2.BAT            Node 2 chess calling batch file
  263.  5. DDCONFIG.SYS           Supplied by Double Dos
  264.  6. DBLDANSI.SYS           Supplied by Double Dos 
  265.  7. CONFIG.SYS             Allows color graphics on 2 nodes
  266.  8. AUTOEXEC.BAT           Gets it all started
  267.  9. SHARE                  Supplied by DOS 3.X
  268. 10. MENU51                 Shows node 2 doors menu.
  269. 11. MENU52                 Shows node 2 doors menu.
  270.  
  271.  
  272. The RBBS1.BAT file on drive A:
  273.  
  274.  C:                                       Puts you on the RBBS dv 
  275.  WATCHDG1 OFF                             Disarm Watch dog 1
  276.  IF EXIST C:RCTTY1.BAT DEL C:RCTTY1.BAT   Removes node 1 batch
  277.  RBBS-PC 1                                Node 1 RBBS call
  278.  WATCHDG1 ON                              Arm Watch Dog 1
  279.  IF EXIST C:RCTTY1.BAT C:RCTTY1.BAT       Call the Door program
  280.  A:                                       Return to boot drive
  281.  RBBS1                                    Call this batch file
  282.  
  283. The RBBS2.BAT file on drive A:
  284.  
  285.  C:                                       Puts you on the RBBS dv
  286.  WATCHGDG2 OFF                            Disarm Watch Dog 2
  287.  IF EXIST C:RCTTY2.BAT DEL C:RCTTY2.BAT   Removes node 2 batch
  288.  RBBS-PC 2                                Node 2 RBBS call
  289.  WATCHDG2 ON                              Arm Watch Dog 2
  290.  IF EXIST C:RCTTY2.BAT C:RCTTY2.BAT       Call the Door program
  291.  A:                                       Return to boot drive
  292.  RBBS2                                    Call this batch file
  293.  
  294. Notice  that  there is a different Watch Dog program for  node  2 
  295. and node 1. 
  296. The  RCTTY2.BAT is a different name than that in the node 1 call, 
  297. these  different names are made when you run CONFIG when it  asks 
  298. you for the door batch name.
  299.  
  300. The CHESS-1.BAT file on drive C:
  301.  
  302.  C:                        Insure you are on RBBS drive
  303.  WATCHDG1 OFF              Disarm Watch Dog for Chess software
  304.                            because it has its own line monitor 
  305.                            and if you use Watch Dog and someone 
  306.                            hangs up in chess it will disconnect 
  307.                            the user on the other node!!!
  308.  CHESSDOR 1%               Calls node 1 chess
  309.  
  310. The CHESS-2.BAT file on driv C:
  311.  
  312.  C:                        Insure you are on the RBBS drive
  313.  WATCHDG2 OFF              Disarm Watch Dog (see above)
  314.  CHESSDOR 1%                Calls node 2 chess
  315.  
  316. Do  NOT  remove  the 'WATCHDGx ON' call from  the  RBBS1.BAT  and 
  317. RBBS2.BAT  files as they are needed when you go to your DOS  from 
  318. remote (7 from the main menu).
  319.  
  320.  
  321.  
  322.  
  323. The DDCONFIG.SYS file on drive C:
  324.  
  325. Set the parameters as you like (as your system requires),  but if 
  326. you use the file names that I have used in this example then  the 
  327. following parameters should be set as stated:
  328.  
  329.  top program = A:RBBS1
  330.  bottom program = A:RBBS2
  331.  
  332. The following parameters should be set as follows:
  333.  
  334.  top size = half
  335.  priority = equal
  336.  
  337. The  DBLDANSI.SYS  file supplied  must be available on the  drive 
  338. that Double Dos is installed on.
  339.  
  340. Your CONFIG.SYS (on both drive A & C) 
  341. file should be changed as follows: 
  342.  
  343. You  should  REMOVE  the DEVICE = ANSI.SYS  statement  from  your 
  344. CONFIG.SYS and insert DEVICE = DBLDANSI.SYS in its place.
  345. If  you  don't  use  a CONFIG.SYS then make  on  with  the  above 
  346. statement in it.
  347.  
  348. The AUTOEXEC.BAT file on drive A:
  349.  
  350.  A:                           Insure you are on the boot drive
  351.  SHARE                        Program supplied with DOS 3.X
  352.  C:                           Call drive that Double Dos is on
  353.  DOUBLEDO                     Call Double Dos
  354.  
  355. The MENU51 file on drive as stated in RBBS1PC.DEF file:
  356.  
  357. Must  have  the door listed as 'CHESS-1' as the door if you  used 
  358. the same file names as I have (see supplied MENU51 file).
  359.  
  360. The MENU52 file on drive as stated in RBBS2PC.DEF file:
  361.  
  362. Must  have the door listed as 'CHESS-2' as the door if  you  used 
  363. the same file names as I have (see supplied MENU52 file).
  364.  
  365. The following is for Multi-Link
  366. -------------------------------
  367.  
  368. You must be running DOS 3.X or higher.
  369. When  using  CONFIG.EXE (supplied with the RBBS-PC) on  selection 
  370. #81 state using doors 'YES',  using MULTILINK 'YES', window state 
  371. '0'  any other window number will caused the CHESSDOR program  to 
  372. hang.   Therefore if you are using software that requires another 
  373. window number you CANNOT use the doors for both!!!
  374.  
  375.  
  376.  
  377.  
  378. You must have the following files:
  379.  
  380.  1. RBBS1.BAT                  Node 1 calling batch file.
  381.  2. RBBS2.BAT                  Node 2 calling batch file.
  382.  3. CHESS-1.BAT                Node 1 chess calling batch file.
  383.  4. CHESS-2.BAT                Node 2 chess calling batch file.
  384.  5. AUTOEXEC.BAT               Gets it all started.
  385.  6. AUTOEXE1.BAT               Gets node 1 started.
  386.  7. AUTOEXE2.BAT               Gets node 2 started.
  387.  8. SHARE                      Supplied by DOS 3.X.
  388.  9. MENU51                     Shows node 1 doors menu.
  389. 10. MENU52                     Shoos node 2 doors menu.
  390.  
  391. All  the  above files are set up the same way for  Multi-Link  as 
  392. they were for Double Dos (except for AUTOEXEx.BAT) and you should 
  393. see the examples in the above Double Dos area for how to set them 
  394. up.
  395.  
  396. The AUTOEXEC.BAT file on drive A:
  397.  
  398.  A:                         Insure you are on the boot drive
  399.  SHARE                      Supplied with DOS 3.X
  400.  MLINK /9,172/9,172         Start Multi Link on 2 nodes
  401.       
  402. The AUTOEXE1.BAT file on drive A:
  403.  
  404.  RBBS1                      Starts node 1 RBBS.
  405.  
  406. The AUTOEXE2.BAT file on drive A:
  407.  
  408.  RBBS2                      Starts node 2 RBBS.
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433. 2.3 Running the chess game
  434. --------------------------
  435. After  completing  the  setup as stated above  insure  that  when 
  436. running the CONFIG file for the RBBS that you have the doors open 
  437. and  allow  the correct access level users to use the doors  that 
  438. you want.
  439.  
  440. On  the Main menu of the chess Monitor the name you have assigned 
  441. to your RBBS via the CONFIG program will be placed as part of the 
  442. header.
  443.  
  444. That  is all that is needed to make this work in remote.   To run 
  445. the  program in local you must sign on the RBBS at your  keyboard 
  446. (remember  what node if you are multi tasking) and then when  the 
  447. Main menu is displayed sign off. Then break out of the batch loop 
  448. and  enter  CHESSDOR  (If you  are  running  NON-Multi  Tasking), 
  449. CHESSDOR 1 (If you are on node 1), CHESSDOR 2 (If you are on node 
  450. 2).   This  will bring up the chess monitor in local and you  can 
  451. run/play in the local mode which functions the same as remote.
  452.  
  453. The  first time you bring up the system it will build the  number 
  454. of  the  required game files and inform you that it  is  building 
  455. them.   This will also happen whenever you increase the number of 
  456. games  that  are  allowed.   If you decease the number  of  games 
  457. allowed  any active games above the number set can no  longer  be 
  458. played!!
  459.  
  460. While  watching  the  screen when a remote user is on  the  chess 
  461. monitor  you will see the users name is in the lower left  connor 
  462. of  the  screen,  in  the middle will be the  version  #  of  the 
  463. CHESSDOR.EXE  program  that  you are using and the node  that  is 
  464. operating, and on the right side you will have displayed the time 
  465. the user started using the chess monitor.  At the top on the main 
  466. menu the banner will have the name of you RBBS as stated when you 
  467. ran the CONFIG program.  Also when the remote users screen does a 
  468. clear  yours  will NOT it will just  print  (CLEAR  SCREEN).  The 
  469. purpose  of this is to keep the 25 line on your screen and  clear 
  470. to remote users screen.
  471.  
  472. Whenever  you  are  on the system,  either local  or  remote  the 
  473. software  will  know you as the sysop and you will have  one  (1) 
  474. extra  function on the main menu and that is function  6A.   This 
  475. function  will  allow you to remove the  validity  checking  when 
  476. making  moves and also allows you to insert pieces.   Follow  the 
  477. instructions for format to insert pieces ie to remove a piece you 
  478. can  enter ;E4 this will place a blank space (remove) at location 
  479. E4  on  the chess board.   If you enter WQ;E4 this will  place  a 
  480. White  Queen at location E4.   BEWARE when you are in  the  sysop 
  481. mode  with no validation being done you can creat problems so  be 
  482. very careful when using this.
  483.  
  484. If  you  are playing a game yourself with one of  the  users  you 
  485. should  insure  that the sysop mode is equal to 0 to insure  that 
  486. all the validity checks are done.
  487.  
  488. The  following  two paragraphs are only true when using NO  multi 
  489. tasking or when using Double DOS.
  490.  
  491. Pressing  the  function  #10 key while a remote user  is  on  the 
  492. system will place you in the chat mode and allow you to talk with 
  493. the player.   To return the player to the game you must press the 
  494. ESC  key this is the same procedure as on the RBBS.   The  player 
  495. does NOT have a function on his menu to call you.
  496.  
  497. Pressing the function #8 key allows you to reduce or increase the 
  498. time the player is allowed to stay on chess this one  time.   You 
  499. will  get a prompt for the number of minutes you wish to let them 
  500. have then you enter a number and press enter.   This will cause a 
  501. message  to be place on the screen to inform the player that  the 
  502. amount of time has changed.
  503.  
  504. Good luck and enjoy this software.
  505.  
  506.                                  Bob...
  507.